Blacklist Check V1 （Overdue 7+)
To access
Welcome to use our product. Here are some things you need to know before you start the interface call:
- Complete product signing and permission opening;
- You need to obtain an appKey and secret.
- We provide a demo java python php，for your reference;
- Please feel free to contact us if you have any questions.
token description
Write all request parameters and secrets (assigned when opening an account) except tokens in the form of "key=value", sort them by key, and connect them with "&" to get the string str：
String str = "appKey=test_key&idNumber=idNumber&name=name&phone=phone&secret=20200101";
Encrypt str with md5 to get the token:
String token = md5(str);
For details, please refer to calling demo
Interface information
| API | API information |
|---|---|
| formal environment | http://api.digiscore.id/api/data/blackListV1/handle |
| sandbox environment | http://test-platform.ferrystatic.com/openrisk/api/data/blackListV1/handle |
Request parameter
| Field | type | required | describe |
|---|---|---|---|
| appKey | string | yes | Unique identifier assigned to the organization |
| token | string | yes | API request signature, see token description |
| name | string | yes | Name of the user. |
| idNumber | string | yes | KTP number of the user. |
| phone | string | yes | Phone number of the user. All Phone number have to remove the country prefix. |
Response parameters
| Field | type | required | describe |
|---|---|---|---|
| code | int | yes | error code |
| msg | string | yes | Error message |
| data | object | no | See business parameters below for details |
| isFee | int | yes | 1- charge, 0- free |
Business parameters
| Field | type | required | describe |
|---|---|---|---|
| phone_isBlack | string | yes | Check whether the mobile number matches the blacklist. 1- hit |
| phone_lastDate_due | float | yes | mobile number the most recent entry date，yyyy-mm-dd |
| nik_isBlack | string | yes | If the ID number matches the blacklist, 1- hit |
| nik_lastDate_due | string | yes | Id number the most recent entry date，yyyy-mm-dd |
| maxAmount_due | string | yes | Maximum overdue amount |
Response example
success
{
"code": 200,
"msg": "success ",
"data": {
"phone_isBlack": "1",
"phone_lastDate_due": "2021-09-15"
"nik_isBlack": "",
"nik_lastDate_due": ""
"maxAmount_due": "909000"
},
"isFee": 1
}
error
{
"code": 11008,
"msg": "xxxxxxxxx",
"data": null
"isFee": 0
}